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Release and Installation Notes 
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1. Preface 

This document contains important information about the SCO UNIX 
Development System. 

These notes are divided into two parts: software notes, and Appen¬ 
dix A, “New and Revised Manual Pages.” The appendix is not 
listed in the table of contents. 

The software notes are organized into the following sections: 

• Installation Notes 

• General Software Notes 

• C Language Notes 

• SCO UNIX Development System Documentation Notes 

• POSIX Implementation Defined Issues 

• SCO 3.2 Product Engineering Toolkit Notes 
. ISAM Development System Notes 

We are always pleased to hear of users’ experiences with our prod¬ 
ucts, and welcome recommendations on how they can be made 
even more useful. All written suggestions are given serious con- 

sideration. 

1.1 Conventions Used in These Notes 

Utilities and commands are printed in boldface type, with the refer¬ 
ence guide section following in parentheses. For example, 
fsck(ADM) refers to the fsck manual page in the System Adminis¬ 
tration (ADM) section. Filenames are in italics. For example, you 
see the letcldefaultlfilesys file. 
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1.2 Contents of the Distribution 

The components of your Development System package include: 


SCO UNIX System V Development System 

The Development System provides programs and com¬ 
mands for creating, debugging, and maintaining C lan¬ 
guage and assembly language programs. It includes: 

CodeView, a window-oriented debugger 


- MASM, the Microsoft® Macro Assembler, which 
lets you link, assemble, and run assembly lan¬ 
guage programs. 


• SCO CGI Development System 

SCO CGI (Computer Graphics Interface) provides th< 
tools to create graphics applications packages for the 
System V environment. The SCO CGI package also con- 
tains selected graphics device drivers for developers tc 
test their graphics applications on various peripherals. 

SCO CGI is a separately installable product, and installa¬ 
tion instructions are included in the CGI Release and In¬ 
stallation Notes. 


SCO Product Engineering Toolkit 

The Product Engineering Toolkit allows you to create a 
standard installation interface for your applications. The 
interface is consistent with that of SCO products and 
pnmdes users with all of the options of’ the 
custom(ADM) utility. 

SCO ISAM 


SCO ISAM (indexed sequential access method) provides 
a complete set of tools for a programmer to build custom 


18 July 1990/3.2.2 


-2- 


The Santa Cruz Operation 









SCO UNIX Development System 


data management procedures into any type of applica 
tion. 


1.2.1 Documentation 

For a complete list and description of the accompanying documen¬ 
tation, see the documentation roadmap included m the Develop¬ 
ment System package. 

1.2.2 Installation Media 

The SCO UNIX Development System is distributed on 96 tpi and 
135 tpi diskettes for standard architecture machines. The software 
is grouped into several functional areas called packages. is 
makes customizing your system easier, because you can use the 
custom(ADM) utility to add or delete groups of related programs. 

1.2.3 Serialization Card 

This contains your serial number and activation key, both of which 
are needed to install the SCO UNIX Development System. 


1.3 Software Support 

Software support is available to customers who purchased the SCO 
UNIX Development System for use in the United States and 
Canada. If you purchased it for use outside of the U.S. or Canada, 
contact your distributor or retailer for support information. 

Software support is described on the Customer Registration Form 
included with your SCO UNIX Development System documenta¬ 
tion. Complete the form and return it to us within five days ot 
receiving your software package. To be eligible for our support 
services, please supply all information requested on the form. 

2. Installation Notes 

You must have SCO UNIX System V/386 Release 3.2 installed on 
your computer to use the SCO UNIX System V/386 Development 
System Release 3.2. 
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2.1 Removing an Earlier Release 

If you currently have an earlier release of the SCO UNIX System V 
Development System installed on your system, you must remove i, 

release- 118 l ° ** f ° ° Wing P rocedure before you install the current 


1 . 


Save a copy of !etc!perms!dsmd in another directory For 
example, type: 

cp /etc/perms/dsmd /tmp/foo/dsmd 

Removal of the SCO UNIX System V Development System 
removes this file as well, and it is required for subsequent 
reinstallation of the Development System. Do not store the 
e directly under the /tmp directory, as it can be removed 
from there as well. 

^nfn^ t ? m(ADM) ’ rem ° Ve ^ P revi ous version of the 
SCO UNIX System V Development System. 

Exit custom, then restore /etc!perms!dsmd from the copy 
you made in step 1 . 


2.2 Installing the SCO UNIX Development System 

Before you install the Development System, make sure that you 


• the Development System installation media 

• the Operating System “N” volume diskettes. Depending 
on your installation, you are prompted to insert one or 
more of these diskettes as part of your Development Sys- 
tern installation procedure. 

• your Development System serial number and activation 
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To install the Development System, follow these steps: 

1 . Log in as root (the super user) and bring the system to sys¬ 
tem maintenance mode. 

2. Enter the following command at the prompt: 

custom 

3. The main custom menu is displayed. Select Install. 

4. Select A New Product. 

5. If you want to install the entire Development System, 
select Entire Product. If you want to install specific pack¬ 
ages only, select Packages. 

6 . This message is displayed: 

Insert: Distribution 

Floppy Volume 1 

Insert the volume labeled “D01” into floppy drive 0, and 
press (Return). 

7. If you chose the Entire Product option, skip to step 8. 

If you chose to install Packages, the package list is dis¬ 
played: 

ALL Entire Development System set 

PERM Development System permlists 

SOFT Basic Software Development Tools 

XNXDEV XENIX cross development include files and uti s 

386XDEV XENIX 386 Cross Development libraries 

286XDEV XENIX 286 cross development libraries 

LEX Generates programs for lexical analysis 

YACC Yet another compiler“compiler 

CFLOW Generates C flow graphs 

LINT Syntax and usage check files and tools 

SCCS Source code control system 

DOSDEV DOS cross development utilities and libraries 
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ISSr S?mT° SS deVeloFnent i^aries and utilities 
MESGCAT XPG Message Catalog Utils 

SAMPLE Sanple Shell Scripts for the PE ibolkit 

Development system manual pages 

The Distribution Making Ibols 

The Man Package for the PE Tbolkit 

SCO ISAM OMF Format Libraries 

SCO ISAM COFF Format Libraries 


MAN 

PETKIT 

KIIMAN 

ISOMF 

ISCOFF 


Select the packages you want to install by moving the 
highlight to each desired package and pressing (Space). 
Selected packages are marked with an asterisk (*) When 

press (Re,„™T ked *" ^ PaCkagK U,a ' y0U wan ' *° ^ 


9. 


This message is displayed: 

Insert: Software Development System 
Floppy Volume D1 

Depending on which packages you chose to install, , 
different volume number might be requested first. 

Insert the requested volume and press (Return). 

Insert the other volumes as they are requested. When you 
have installed the last package, the Restricted Rights 
Legend is displayed, followed by this message: 

Product Serialization 


10 . 


When prompted, use the serial nunfcer and activate 
key included with the Product distribution. 

Enter your serial number or enter q to quit: 

Type your serial number, and press (Return). 


11 • Now this message is displayed: 

Enter your activation key or enter q to quit 

Type your activation key, and press (Return). 
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12. After some time, this message is displayed: 

press any key to continue. 

Press any key. You are prompted to insert one or more of 
the “N” volumes. The “N” diskettes are not part of the 
Development System distribution (although custom might 
refer to them as “Development System” diskettes). They 
are volumes from the operating system distribution and 
certain operating system dependent files and utilities must 
be extracted from them when you install the Development 
System. 

13. After the “N” volumes are installed, you return to the cus¬ 
tom menu. The installation is now complete. Select Quit 
from the custom menu to exit custom. 

After you install the SCO UNIX Development System, check the file 
I etc! default! cc to confirm that the default settings for the compiler 
meet your needs. 

3. Development System Software Notes 

3.1 ANSI Conformance 

The Microsoft C compiler and libraries included with the SCO 
UNIX System V/386 Development System are substantially confor¬ 
mant with the draft proposed ANSI C Programming Language stan¬ 
dard X3.159-198X dated May 13,1988. 

The Development System manual pages in the Programmers 
Reference include a section on standards conformance to provide a 
guide to those functions that are compliant with ANSI C, IEEE and 
FIPS POSIX, and X/Open or SVID. 

3.2 CodeView 

The CodeView debugger shipped with this release recognizes the 
following options: 
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-c special commands 

■t sequential mode 

-b monochrome display 


See the CodeView Debugger manual for more information on 
CodeView options. 

In the CodeView documentation, there are special functions 
described that are accessed using the (Alt) key in conjunction with 

? the / r /S7 S ' 1 By default ’ these functions are not available. The file 
lusr/hblkeyboard/cv, which is included in your standard distribu¬ 
tion, must be renamed to replace the file lusrllib/keyboard/keys in 
I'™ the special functions of keys used in conjunction 

th the (Alt) key. The original /usr/lib/keyboard/keys file should 
e saved as a precaution. For example, to perform the above 
described operation, log in as root (the super user) and give the fol¬ 
lowing commands: 


mv/usr/lib/keyboard/keys /usr/lib/keyboard/keys.bkp 
cp /usr/lib/keyboard/cv /usr/lib/keyboard/keys 

You should also add the following command to the /etc/rc file to 
time*- 1 ^° Ur SyStem t0 custom * ze th 6 keyboard automatically at boot 


mapkey 


However, if your system has an (F12) key, the (Alt) key functions 

can be used by first pressing (FI2) and then the (Alt)(*ey) combina- 
tion needed. 


Floating-point support is not yet implemented in CodeView. 
CodeView cannot be used to debug 286 binaries. 

Known problems with the CodeView software include: 


Mouse support in CodeView is not available in this 
release. 
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. The shell escape does not function correctly at this time. 

• The E command (Execute until keypress) does not work 
properly. 

• Regular expression searching is implemented using the 
regex library, rather than the notation described in the 
CodeView Debugger documentation. 

. Programs that interact with the video driver to map the 
video memory, to use graphics mode, or to switch screens 
cause CodeView to behave irregularly. However, use of 
the normal multiscreens is available without difficulty. 

3.3 crypt(C) and crypt(S) Libraries 

The crypt(C) utility and crypt(S) libraries are not included in this 
release. If you are a United States resident, you can request a copy 
of crypt by calling your support center. 

3.4 cxref(CP) 

cxref(CP) does not correctly handle function prototypes. Its syntax 
analysis is based on an older version of the compiler. To work 
around this problem, make function prototypes subject to a condi¬ 
tional compilation definition. For example. 

tifndef NO_PROTOTYPE 

int func( char *, long ); 

#endif 

Then use this flag when using cxref: 

-DNOJPROTOTYPE 

3.5 help(CP) 

The help(CP) package provides explanations of SCCS error mes 
sages only. For information on other commands, use man(CT). 
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3.6 ld(CP) 

The -r option of ld(CP) does not work cotrectly for object files that 
conutn the addnional symbol table information US e d J b y “ e VyZ 
bohc debngger If you use, u, e „ option of [o p y >™ 

inf,!!", *' 0 ? objec ' modllles lhat contain symbolic debugging 
information, the code, data, and relocation infomration if t!!e 

ZStCsab"' " bU ' ,he Symbolic i»‘ 

3.7 ranlib(CP) 

with ra'nlibtfpi'heT m0dify ” ° MF libra ^- *«• P"*ess it 
With ranlib(CP) before you use it. If you do not, Id(CP) fails. 

Do not process COFF libraries with ranlib. 

3.8 nm(CP) 

The -n option of nm(CP) generates an error with long name lists 
command lbtef ^ ° f 

nm executable | sort 

3.9 OMF/COFF Utilities 

^°"° f wing utiIi * ieS determine whet her a subject file is of OMF 
or COFF format and execute different binaries in each case: 

Id 

ar 

nm 

size 

strip 

T Ving my file that ^se utilities depend 
th P e message ,b/coffand ,llb,x °“0 causes an error. You see 

can, t exec <filename> 
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3.10 sccs(CP) Line Size 

There is a limit of 508 characters on any physical line of any file 
placed under sees. Writing a changed file with a line contaming 
more than 508 characters results in corruption of the file. 

3.11 sdb(CP) 

Programs that are debugged with sdb must be compiled and linked 
with the following options: 

cc -Zi or cc -g 

Id -g 

The following features of sdb that are described in the documenta¬ 
tion are not supported in this release. 

• sdb is not available for OMF binaries. 

• Pattern matching for function and variable names is not 
available. For example, the following string should dis¬ 
play the values of all variables with names beginning 

with “x”: 
x*/ 

• The command to redisplay the value of the last vari¬ 
able typed is not available. 

• The command to read sdb commands in from a file works 
correctly only when there is no space placed between the 
“<” character and the filename: 

* <file 

These features are available with CodeView. 
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3.12 Converting Binaries 

TTie binary conversion utilities cvtcofKM) and cvtomf(M) can be 
sed to convert compiled bmaries between Common Object File 

restrictions^^ ^ ^ XENK# file ^ (0MF >’ wi * 

Any source code using the following files or the related system 

“r Sh0U ' d * C ° mm ed af " r “"’Pi'a.io;, 


File 

Description 

a.out.h 

core.h 

lockcmn.h 

mon.h 

tinfo.h 

sys/fcntl.h 

sys/Iocking.h 

syslshm.h 

sys/signal.h 

sys/utsname.h 

CUFF vs. x.out binary formats 

core file analysis 

file lock requests for x.out binaries 
monitor(S) and profiling data, such as mon.out 
terminfo curses 

fcntl(S) and lockf(S) file lock requests 
locking(S) system call 
shared memory segments (IPC) 

SIGPOLL value 
uname(S) system call 


3.12.1 Using cvtomf(M) 


The crtoraRM) “'ility translates OMF relocatable object files to 

Sables ° bjeC1 fileS ' “ Cann0 ' conve " X 0M f °™at ™- 
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Important 

cvtomf(M) was designed to be used by the Microsoft C 
compiler driver. Using this utility in any other manner can 
introduce binary incompatibilities in the resulting COFF 
file that adversely affect runtime behavior. 


The usage listed in the cvtomf(M) manual page is not complete. 
Here is the correct usage: 

cvtomf [-g] [-o outfile]filelist 

The -g option causes symbolic debug data to be converted. Sym¬ 
bolic data does not translate properly if the OMF file contains mu - 
tiple modules, produced by incremental linkage using ld(M) -r. 
This option functions the same as the -g option to cc(CP). 

The -o option allows you to specify an output filename when a sin¬ 
gle file is being converted. By default, the COFF output overwrites 

the OMF input. 

3.12.2 Using cvtcofffM) 

The cvtcoff(M) utility translates a COFF relocatable object file, 
archive, or executable to the corresponding OMF/x.out format file. 


Important 

cvtcofRM) was designed to be used by the Microsoft linker 
and CodeView. Using this utility in any other manner can 
introduce binary incompatibilities in the resulting 
OMF/x.out file that adversely affect runtime behavior. 


18 July 1990/3.2.2 


-13 - The Sania Cruz Operation 














Release and Installation Notes 


The usage listed in the cvtcoIRM) manual page is not complete. 
Here is the correct usage: 

cvtcoff [-gv] [-o outfile] file 

The -g option causes symbolic debug data to be converted. This 
option can be used in the conversion of COFF executables only, 
an not with relocatable objects or archives. This option functions 
the same as the -g option to cc(CP). 

By default, th e output file is named x.out. The -o option lets you 
specify a different filename. y 

3.13 XENIX Software Products 

When installing XENIX products on your SCO UNIX Operating Sys¬ 
tem, note that the libraries and include files provided are for pro¬ 
ducing x.out format binaries only. Therefore, until other products 
are updated for 3.2, you should use the -xout, -x2.3, or the -xenix 
options when compiling using older XENIX products. 

4. C Language Notes 
4.1 brkctl(S) Library 

mn?,T IX SyS !f m V d ° eS n0t support 386 Processes that have 
Ubhns^r^iT f 6gment ' For compatibility, a special library 

rfoTk^ 15 P ? d *5“ mapS brkct, 0 functions into 
X ? 1Spr ° VldeS for the most common uses of 
brkctl(S), such as the allocation of additional memory. 

^ ramS f ? at re ' y °? allOCating multi P le data segments and mani¬ 
pulating the sizes of those segments need to be altered to work 
under SCO UNIX System V. K 

Tbe following describes the functionality implemented by the 386 
libbtkctl.a Note in particular that the 386 brkctl(S) returns a near 
pointer and that the third argument is also a near pointer. If you do 
not wish to alter your source code when compiling for the 386 vou 
should mclude -Dfar= on d,e cc(CP) command line, rafcau^ 
the preprocessor to remove all “far” keywords from your code. 
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#include <sys/brk.h> 

char *brkctl(cmd, inc, ptr) 

int cmd; 

long inc; 

char *ptr; 

When called from 386 processes, brkctl( ) does not cause the allo¬ 
cation or de-allocation of far data segments. It can only be used to 
increase or decrease the memory allocation in the single data seg¬ 
ment available to 386 processes. 

Any of the commands BR_IMPSEG, BR_ARGSEG or 
BR NEWSEG can be used as they all have the same effect. 

The ptr argument in the above program example is ignored. 

It is unusual to allow the use of BR_NEWSEG with 386 processes 
because it is not possible to allocate additional data segments. 
However, BR_NEWSEG is commonly used in small and middle 
model 86/286 processes to allocate additional memory. Therefore, 
it was decided to give BR_NEWSEG the same functionality as 
BR_IMPSEG. 

In order to link a 386 binary with this version of brkctl() you 
should specify -lbrkctl on the cc(CP) command line. 

4.2 cc(CP) Defaults 

The default code generation model for the 80386 is -M3e. (80386 
with non-ANSI extensions enabled.) This default can be changed 
by editing / etc/default!cc. See the cc(CP) manual page for details. 

4.3 International Development 

This section describes enhancements provided by the SCO Interna¬ 
tional Development System. 
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4.3.1 conv(S) Routines 

Two macros, todigit and toint, have been added. The todigit macro 
returns the digit character associated with the integers 0-9. The 
tomt macro does the opposite. 

The macro definitions of toupper and tolower have been replaced 
by library functions. This is to introduce behavior that is a superset 
ot the ANSI standard and equivalent to SVID and X/OPEN. 

^ie arguments to toupper and tolower are converted to integers. 

or this reason, care should be taken that character arguments are 
supplied as unsigned characters to avoid problems with sign- 
extension of 8-bit character values. 

4.3.2 ctype(S) Routines 

Several macros have been revised to accommodate 8-bit characters. 
While isascn is defined on all integer values, the rest are defined on 
integers, the value of which can be represented as an unsigned 
char, or is equal to the single non-character value EOF. 

4.3.3 Limitations 

Although the underlying libraries used by the Development System 
and other utilities have been modified to function with 8-bit charac- 
ters, only a key number of utilities have been verified to function 
properly in all cases. Unless the utility or routine is listed as 
ven ed in these notes, data files and keyboard input should be re¬ 
stricted to 7-bit ASCII characters. For example, in the case of the C 
compiler, 8-bit characters can be used in character and string 
literals. However, for reasons of compatibility with other utilities 
an C compilers on other systems, it is important to confine use of 
- it characters to data files and to use \nnn escapes to specify 8-bit 
characters within C source. 
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4.3.4 Native Language Support 

A number of routines have been introduced to ensure compatibility 
with the X/OPEN Portability Guide. The routines are nljmt, 
nl extime, nl_printf, nl_langinfo, nl_scanf, and nl_strcmp. 

The nl_init routine is the X/OPEN equivalent of setlocale. 

4.3.5 Regular Expression Routines 

The regexp and regex routines have been verified for 8-bit opera¬ 
tion. The regexp syntax has been extended to accommodate 8-bit 
characters. Refer to the ed(C) manual page for more information. 

As part of the modifications for 8-bit operation, the amount of 
storage required for character ranges in the compiled expression 
may be double that of the standard requirement. 

4.3.6 The setlocale(S) Routine 

The setlocale routine is used to read or set the international 
environment according to a specified category and locale. 

At program startup the equivalent of the following call is executed: 
setlocale(LC_ALL, "") 

This is so that the initial locale for the program is defined as in the 
user environment. 

4.3.7 The strftime(S) Routine 

This routine converts and formats date and time information used 
by applications. 

4.3.8 String Collation 

String collating routines have been introduced to accommodate 8- 
bit character sets. 


18 July 1990/3.2.2 


-17 - The Santa Cruz Operation 









Release and Installation Notes 


4.3.9 irand48() and krand48() 

2eas f e nCti ° nS irand48() krand48 0 are not supported in this 

4.4 Longest Allowed Path Names 

The longest path name in a C program is restricted to 1024 bytes 
ystem calls that require path names as arguments now fail setting 
ermo to ENAMETOOLONG, if a longer path name is gTven § 

Previously, the path name was not restricted by the operating sys- 
^m, however, most programs gave an ad hoc limit to the lfngrti 
Generally, these limits were well below 1024 bytes, so most pro¬ 
grams should not be affected by this change. 

Note also that any path component longer than 14 characters also 
causes ENAMETOOLONG to be set. characters also 

The limits.h file defines a macro _POSIX_PATH MAX to be the 

rosix rlTO°Ux ath T e ' Use pa,hconf7> 10 dete ™"' 

rUMX_PATH_MAX portably over various FFS filesystem types 
wiKhl rt?• toC0ITeC " y ** the maCT ° » 256. bS, i. 

POsIxTaTH Z, Cha "* e «» value " fa 

POSIX_PATH_MAX to 1024 without harm, as the current sys¬ 
tem internally uses the longer limit. y 

You are encouraged to include the limm.h Die wilh a statement 
♦include <limits.h> 

and to refer to the _POSIX_PATH_MAX macro fa fa longest 
path name allowed. g 

4.5 malloc Issues 

° f T U0C diS,ribuKd wilh «“ Development 
ystem. The standard malloc is contained in the file llibllibca 

There is an alternate malloc in /lib/libmalloc.a. Both are docu¬ 
mented under the malloc(S) manual page 
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If your program uses many malloc and free calls, running the pro¬ 
gram under the System V/386 Operating System can cause an 
excessive page swapping problem as malloc must search the entire 
list of allocated and free blocks. If you are using malloc and free 
calls extensively, it is suggested that you use the alternate malloc 
found in llibllibmalloc.a. To use lUbllibmalloc.a, compile your pro¬ 
gram with the -lmalloc flag on your cc(CP) command line. 

The alternate malloc maintains a separate list of free blocks and 
can be faster, but data in any allocated block is immediately 
overwritten when the block is declared free. The standard malloc 
preserves data between consecutive free and malloc calls. Some 
programs rely on this functionality of the standard malloc. 

4.5.1 mallinfo() 

Note that you must call malloc() at least once before calling mal- 
linfo(). Otherwise, calling mallinfo() can result in unpredictable 
behavior. 

4.6 Memory Models 

The only memory model supported for 386 code is “small” model. 
Small model has two 32 bit segments; one for code and one for 
data. Small, middle, large, huge, and compact models are supported 
for 8086/286 code. 

4.7 MINDOUBLE 

The C compiler does not compute the value of the constant MIN¬ 
DOUBLE correctly. It always evaluates to 0 when used in expres¬ 
sions. This constant is defined in / usr / include! values.h. 

4.8 Preprocessor Names 

Symbols which are used in #define, #ifdef and other preprocessor 
commands must now conform to the same rules as those for C 
identifiers. They must begin with an alphabetic character or an 
underscore and can only contain alphanumeric characters and the 
underscore character. 
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Previous versions of the C compiler allowed other non- 
alphanumeric characters such as in preprocessor symbols. 

4.9 Stack Size 

80386 programs have a variable sized stack that is expanded by the 
kernel as needed. 8086/286 programs run under the 386 Operating 
System have a fixed size stack. The default stack size for 8086/286 
binaries is 4 Kilobytes unless the -F option of the linker was used. 
Once compiled, you can change the stack size of an 8086/286 pro¬ 
gram using the -F option to fixhdr(C). 

4.10 Checking Storage Class in Declarations 

The ANSI standard requires that declarations and definitions of 
functions and variables must have matching storage classes as well 
as matching types. Typically, this causes problems in code when a 
function is first used (and implicitly declares it as an “extern int”) 
and is later defined as “static int.” ANSI requires that the first use 
of the function be preceded by an explicit declaration. For exam¬ 
ple: 

static int foo(); /*required by ANSI C */ 

Program text 

foo () ; 
static foo() 

The -Me option disables this strict checking of storage class. 

4.11 String Constants 

The 386 C compiler has been extended to allow 4Kbytes in string 
constants. The compiler generates the following message if this 
limit is exceeded: 

string too big, trailing characters truncated. 
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4.12 Substituting Parameters in Quoted Strings 

The proposed ANSI standard for C does not allow the substitution 
of macro formal parameters within quoted strings. However, many 
existing C compilers allow this. Consider the following macro 
definition and use: 

♦define CTRL(c) (' c ' & 0xlf) 

putchar(CTRL(g)); 

The above statement operates as intended when using the AT&T 
Compiler. The AT&T compiler expands this to: 

putchar (('g' & Oxlf)); 

But according to the ANSI standard it must be: 

putchar ( ('c' & Oxlf) ) ; 

The Microsoft C compiler follows the ANSI standard strictly, 
therefore you must use this substitution as follows: 

♦define CTRL(c) <c & Oxlf) 

putchar(CTRL('g' ) ) ; 

Then the compiler expands this to: 

putchar(('g% & Oxlf)); 

The -xpg2 option to the 386 C compiler allows the non-ANSI func¬ 
tionality described above, but displays a warning that a non¬ 
standard extension has been used. 

4.13 terminfo curses 

When you use terminfo curses in a 286 binary, you should compile 
with the -F option set to 2000 or greater to increase the fixed stack 
size. For small model programs, compile with the -i flag. 

4.14 Third-Party Language Library 

If you are using a third-party language product, such as Microsoft 
Pascal, you might experience errors when using the link editor sup¬ 
plied with the language product. This is due to the addition of a 
new library that is necessary for linking modules with C libraries. 
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This library is called /Iib/libh.a and needs to be added explicitly to 
your link command in order to correctly compile your programs. 

4.15 Tokens Following #e!se and #endif 

The C compiler issues a warning if it finds anything other than 
blank space or comments following an #else or #end if preprocessor 
directive. Thus the first example below would produce a warning 
but the second would not. 

#endif M_I386 

#endif /* M_I386 */ 

These warnings are produced at the default level of 1 on both the 
286 and 386 compilers. 

4.16 Transforming Parameters to Strings 

The ANSI standard defines a mechanism for transforming macro 
formal parameters into quoted strings (the stringizing operator 
“#”) and an operator for pasting strings. “##”. These have been 
added to both the 286 and 386 preprocessors. A slight restriction on 
the 386 is that white space is not allowed between the stringizing 
operator and the formal parameter it operates on. 

4.17 types.h 

Some of the C language .h files require that <sys/types.h> be 
included first. An error message generally occurs when a type is 
used in an ^include file but not declared. Often, the problem is 
corrected by including <sys/types.h> earlier in the program. 

4.18 Variable Assignments 

Assignments of the following form generate incorrect code when 
compiled with optimization enabled: 

int i; 

register char *buf; 

buf[ i + i ] = buf[ i ]; 
buf[ i ] = buf[ i + i ] ; 

Note that if “buf” is not a register variable, or if the index 
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expression “i + i” contains any term other than “i”, such as a con¬ 
stant or another variable, correct code is generated. Thus, both of 
these work correctly: 

buf[ i + i + l ] = buf[ i ]; 
buf[ i + n ] = buf[ i ]; 

4.19 Variable Declarations 

The error Segmentation Violation: core dumped 
can occur if you declare too many variables within a single declara¬ 
tion statement. For example, the following text can cause the com¬ 
piler to dump core: 

char * 


Xl, 

/* 

comment */ 


x2. 

/* 

more 

comment 

*/ 

x 9 3 4 ; 

/* 

more 

comment 

*/ 


Twenty-five variables in a declaration is a safe maximum. Break 
longer declarations into two or more statements to avoid this possi¬ 
ble problem. 

4.20 XENIX Cross Development Notes 

The notes in this section refer to points of interest to C program¬ 
mers developing for the XENIX environment only. 

4.20.1 386 Floating Point Emulation 

286 floating point emulation software in 286 Operating Systems 
prior to 2.3 does not correctly execute floating point comparisons 
between the top of the floating point stack and memory. When you 
develop applications using the -dos, or the -MO, -Ml, or -M2 flags, 
you should use the -Go option to cc(CP) to instruct the compiler to 
allow for this. Note that the -compat flag implies the -Go option 
automatically. 

When using masm, special care needs to be taken not to make float¬ 
ing comparisons with memory operands. To execute correctly on 
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previous 286 floating point emulators, only comparisons of 
different stack elements should be made. Note that pushing a mem- 
ory operand onto the stack causes the source/destination relation ^ 
between the two operands to be reversed in a subsequent com¬ 
parison operation. As an example: 

fcom memory_address 
jg label 

should be written as: 

fid memory_addr ess 

fcomp ST(1) 
jl label 

4.20.2 XENIX Device Drivers 


To develop installable device drivers suitable for use under 
XENIX, you must have the XENIX Development packages 


installed. 

4.20.3 setvbuf(S) 


The order of the parameters to setvbuf(S) has been changed to con¬ 
form with the SVID. In releases of the XENIX Operating System 
prior to 2.3, the order of the parameters was: 


int setvbuf (stream, type, buf, size) 


In release 2.3 and later of XENIX and all releases of SCO System V, 
the order of the parameters is: 

int setvbuf (stream, buf, type, size) 


The files /lib/compat[LMCS]setvbuf.o can be used for backwards 
compatibility. 
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5. SCO UNIX Development System Documentation Notes 

5.1 STREAMS Manual Pages 

exit (S) 
fcntl (S) 
getmsg (S) 
ioctl (S) 
open (S) 
poll (S) 
putmsg (S) 
read (S) 
signal (S) 
sigset (S) 
write (S) 

These commands have features or references related to STREAMS. 

Additionally, The (NSL) and (STR) sets of manual pages are 

included in the streams documentation. 

5.2 termcap(S) manual page 

The termcap(S) manual page refers to the stty(S) manual page. 

This reference should be to stty(C). There is no stty(S) manual 

page. 

5.3 atof(S) manual page 

The following line at the top of the atof(S) manual page is 

incorrect: 

#include <math.h> 

The line should read: 

#include <stdlib.h> 
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5.4 atexit(S) Manual Page 

The atexit(S) manual page lists the incorrect return value. Upon 
successful completion, atexit returns a value of 0. On failure it 
returns a value of -1. 

5.5 fieldtype(S) Manual Page 

The final paragraphs under “Syntax” and “Functions” each have 
lines missing a letter. Where the text reads: 

link_fieldtyp (typel,type2) 

it should be: 

link_fieldtype (typel,type2) 

Note the added “e” at the end of “fieldtyp.” 

5.6 stopio(S) Manual Page 

The stopio(S) manual page “Description” section states that stopio 
sends a SIGSYS signal. It should instead say that stopio sends a 
SIGHUP signal. 

5.7 ioctl(S) Manual Page 

The ioctl(S) manual page incorrectly states that “STREAMS errors 
are described in streamio(7).” Instead of streamio(7), it should 
reference streamio(STR), which is in the Streams Programmer's 
Guide, a part of the Development System Developer’s Guide. 

5.8 /usr/sys/conf Should Be /etc/conf/cf.d 

In Appendix E of the Streams Programmer’s Guide (in the Devel¬ 
opment System Developer’s Guide), references to the file 
I usr/sys/conf/master are incorrect. The correct filename is 
/etc/conf/cf.d/mdevice. 

5.9 memmove(S) Manual Page 

The syntax for memmove(S) should direct you to include 

♦include <memory.h> 

as well as 

♦include <string.h> 


18 July 1990/3.2.2 


- 26 - The Santa Cruz Operation 





SCO UNIX Development System 


5.10 directory(S) Manual Page 

To use dirent as described under “Syntax,” you must also include 
sys/ndir.h. 

5.11 SecureWare routines 

In any source file using such SecureWare routines as setluid(S) and 
getluid(S), you must add the line: 

#define SecureWare 

Also, you must link such a file with libprot (using the -Iprot 
option). 

5.12 System Calls Requiring set_auth_parameters() 

When you execute a program that uses or manipulates the protected 
password database, you might get the following error message: 

Authentication database use not initialized first 

This indicates that you need to make a call to 
set_auth_parameters() before attempting to access the protected 
password database. set_auth_parameters() is documented under 
identity(S). 

5.13 cc(CP) Manual Page 

The -Ma option to cc(CP) does not exist. If it is used, cc reports a 
command line error. 

5.14 lint(CP) Manual Page 

The lint(CP) manual page incorrectly lists several options as 

“.rm]B”. The missing options are -Lc, -n, -p, -c, and -o, in that 
order. 
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5.15 The sptalloc(K) Routine 

The Development System Device Driver Writer’s Guide states that 
the base argument to sptalloc(K) is a physical address. Instead, 
that argument is a page frame number. 

5.16 STREAMS Overview 

In the diagram on the first page of Chapter 9, “STREAMS,” in the 
Development System Device Driver Writer’s Guide, the upstream 
and downstream labelling and the read and write queue indicators 
are reversed, relative to the arrows. 

5.17 t accept(NSL) Manual Page 

The syntax for t_accept(NSL) is missing a line. After the include 
statement should be 

int t accept(fd, resfd, call) 


6. POSIX Implementation Defined Issues 

Null pathnames are considered invalid and generate an error. (Rev. 
POSIX FIPS) p. 36 

chown() is restricted to a process with appropriate privileges. C2 
tuning may restrict all cases of chown to root. (Rev. FIPS) 

Only a user with appropriate privileges can set file timestamps to 
arbitrary values using utime(). (Rev. FIPS) 

System V/386 supports a value of NGROUPS_MAX greater than 
or equal to 8. (Rev FIPS) 

chown() restricts changing the group-id of a file to egid or one of 
the supplementary group ids. (Rev. FIPS) 

exec() saves the effective user and group id. (Rev FIPS) 

kill() uses the saved set userid of the receiving process instead of 
the effective uid for determining eligibility of sending a signal. 
(Rev FIPS) 
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Upon exit() of a session process group leader, a SIGHUP is sent to 
each member of the session process group. (Rev FIPS) 

Terminal special characters can be individually disabled using the 
value specified by POSIX_VDISABLE. (Rev. FIPS) 

System V/386 supports POSIX_JOB_CONTROL. (Rev FIPS) 

Support is provided for CPIO and USTAR data formats. (Rev FIPS) 

Pathname components longer than NAME_MAX are invalid and 
generate an error. (Rev. FIPS) 

EBUSY is supported as an ermo value for rename(), rmdirO and 
unlink(). (Rev. FIPS) 

ISUID and ISGID are cleared by chown(), even for root process 
Page 103. 

Only a user with appropriate privileges can link or unlink direc¬ 
tories. (Rev. FIPS) 

The group ID of newly created files and directories is set to the 
group owner of the directory. (Revised POSIX FIPS). 

System V/386 supports modem control on asynchronous serial ter¬ 
minal ports, (see the <config> parameters TERMIOS_TTY, 
TERMIOS_LOOP, and TERMIOS_TTY_NC.) (Rev. POSIX FIPS) 

System V/386 supports the environment variable HOME for the 
login shell as defined in Section 2.7 of the IEEE Std 1988-1003 1 
(Revised POSIX FIPS). 

System V/386 supports the environment variable LOGNAME for 
the login shell as defined in Section 2.7 of the THEE Std 1988- 
1003.1. (Revised POSIX FIPS). 

System V/386 supports tcgetpgrpQ and _POSIX_JOB_CONTROL 
is defined. (Revised POSIX FIPS). See the “Get Foreground Pro¬ 
cess Group ID” in the Device- and Class-Specific Functions 
chapter of the POSIX standard. 


18 July 1990/3.2.2 


- 29 - The Santa Cruz Operation 





Release and Installation Notes 


System V/386 supports links to directories for user with appropriate 
privileges. (Revised POSIX FIPS). See the “Link to a File” in the 
Files and Directories chapter of the POSIX standard. 

Access permission is required to access an existing file. (Revised 
POSIX FIPS). 

System V/386 does not support links between different file systems. 
See the “Link to a File” entry in the Files and Directories chapter 
of the POSIX standard. 

System V/386 supports using unlink() on directories from a user 
with appropriate privileges. (Revised POSIX FTPS). See the 
“Removing Directory Entries” entry in the Files and Directories 
chapter of the POSIX standard. 

System V/386 allows unlinking a directory when it is being used by 
the system or another process. See the “Remove Directory Entries” 
entry in the Files and Directories chapter of the POSIX standard. 

System V/386 allows the removal of a directory that is being used 
by another process. See the “Remove a Directory” section in the 
Files and Directories Chapter of the POSIX standard. 

System V/386 does not require write permission for existing direc¬ 
tories when renaming them. See the “Rename a File” section in 
the Files and Directories chapter of the POSIX standard. 

System V/386 supports a call to rename!) when the directory 
named is in use by the system or another process. See the 
“Rename a File” section in the Files and Directories chapter of the 
POSIX standard. 

System V/386 supports the EINVAL error code for a call to 
access!). See the “File Accessibility” section in the Files and 
Directories Chapter of the POSIX standard. 

System V/386 supports the setting of S_ISUID and S_ISGID by 
chmod(). See the “Change File Modes” section in the Files and 
Directories Chapter of the POSIX standard. 
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System V/3 86 does not support the EINVAL error for a call to 
c own() when an invalid “owner” argument is specified. See the 
Change Owner and Group of a File” section in the Files and 
Directories chapter of the POSIX standard. 

A call to read() or write() that is interrupted by a signal after it has 
successfully read or written any data returns the number of bytes 
read or written. (Revised POSIX FIPS). See “Input and Output 
Primitives” m the POSIX standard. V 

System V/386 supports character size of 5 bits, 6 bits, 7 bits, and 8 
bits. See the “Control Modes” section in the Device and Class 
Specific Functions chapter of the POSIX standard. 

System V/386 does not support changing the START and STOP 
special characters. See the “Special Characters” section in the De¬ 
vice and Class Specific Functions chapter of the POSIX standard. 

System V/386 does not support the inclusion of the groupid with 
supplementary group IDs. See the “Get Supplementary Group 
IDs section m the POSIX standard. 


7. SCO 3.2 Product Engineering Toolkit Notes 

The SCO Product Engineering Toolkit is a collection of utilities that 
aid developers in making their applications products easy to install 
and remove using the SCO custom(ADM) utility 


7.1 Feature Description 

ufihties° Pr ° dUCt Eng ' neering Toolkit Prides the following major 


mkperms 

mkcuts 


generates a permissions list 
prepares and moves distribution 
onto removable media 


files from hard disk 
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hocheck compares the permissions list with the distribution 
files 

fdfjt fits distribution files onto volumes 

fixperm corrects file permissions within permissions list 
pkgsize calculates the disk size of each distribution package 
volno generates volume numbers for each distribution file 


8. ISAM Development System Notes 
8.1 Invoking SCO ISAM 

There are two steps you must complete to use SCO ISAM with a C 
program: 

1 Enter the following line with the other “include state¬ 
ments at the top of your program: 

# include <isam.h> 

2. Link the C program with the SCO ISAM libraries using the 
-lisam compiler option, as in the following example: 

cc filename -lisam 

8.2 Converting C-ISAM files to SCO ISAM 

SCO ISAM is call-compatible with C-ISAM applications as long as 
they use only X-OPEN ISAM calls. Such applications can be con¬ 
verted by linking them with SCO ISAM. However, SCO ISAM 
data and index files are not compatible with C-ISAM data and 
index files. To use C-ISAM applications, you must convert your 
C-ISAM data files to SCO ISAM data files. 

If your data is in an Informix version 3.3 database and you have 
SCO Integra, you can use the “translate” program to convert your 
C-ISAM data files to SCO ISAM. (See the section “Converting 
Informix Files to Integra” in the SCO Integra User’s Guide for 
instructions on using “translate.”) However, if any of the Informix 
data files have a primary key (that is, “key primary” is specified in 
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tl ckTm IC) ’ r 6 tran$lated fi,CS WiI1 n0t WOrk with y° ur exist- 
dal fiwT a PPhcations. This problem occurs because Integra 
ata files always contain an extra four-byte field that is guaranteed 
to be unique, while Informix data files contain an extra four byte 
field only if a primary key is not specified for the file. To avoid 
c anging your existing applications, you should not use “translate” 
on any Informix file that has a primaty key. 

If you canno, ure “iranslaie,” follow ihe procedure outlined below 
onvert your C-ISAM data and index files to SCO ISAM: 

L ^T a ": ISAM Pr ° gram t0 unIoad y° ur data into an 
deirmted fi,e - You can use ldlong(), lddbl() 
ldmt(), and ldfloat() to convert the values in the data files 
from C-ISAM format to numbers. 

2. Rename the C-ISAM .dat and .idx files. 

3. Write an SCO ISAM program to rebuild the files and 
in exes If you have the code originally used to build the 
data and index files in C-ISAM, you can use the same code 
linked with SCO ISAM instead of C-ISAM. 

4 ’ t^ASClfd ? IS \ Mpr ° gram that Ioads the data stored in 
the ASCII delimited files into the SCO ISAM files you cre¬ 
ated m the previous step. You can use stlong() stdblO 

^rASCnd^^^m C ° nVert the nUmberS you read from 

the ASCII delimited files to SCO ISAM format. 

If your C-ISAM applications do not link after you complete this 

XOPEN e isAM eanS y r Ur Pr ° grams Contain cal,s n °t defined in the 
X-OPEN ISAM specification. You need to rewrite these programs 
so that they use only X-OPEN calls. P g ams 
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8.3 Lock Manager Setup and Cleanup 

To avoid the standard configuration limitations of kernel file lock¬ 
ing (often as few as 50 locks in the kernel), a shared memory seg¬ 
ment is used to contain lock tables. Access to this shared memoo' 
segment is regulated by a kernel semaphore. It is not necessary to 
dcfany explicit programming to use this scheme, but it does affect 
the cleanup procedure in abnormal situations. 

8.3.1 Setup 

You might want a separate lock manager table for each application 
accessing its particular sets of files. IPC resources (shared memory 
and semaphores, for example) in the UNIX system are identified by 
a “key.” The key that SCO ISAM uses to set up the shared memory 
and semaphores is taken from the environment variable DBKEY 
All processes you want to operate concurrently on the same set of 
files and records must have the same value for DBKEY. 

To set the value of DBKEY: 


. If you use the Bourne shell, include two lines in each 
user’s .profile file: 

DBKEY=va/ue 
export DBKEY 

There are no spaces around the equals sign. 


. If you use the C shell, include this line in each user’s 
.login file: 

setenv DBKEY value 

In the above examples, value is the value to be assigned to 
DBKEY. 

If two users accessing the same SCO ISAM files do not have the 
same DBKEY, there is no locking protection. 


18 July 1990/3.2.2 


-34- 


The Santa Cruz Operation 





SCO UNIX Development System 


8.3.2 Cleanup 

“aS '7 £? r ager shared - memo 'y segment an- 
However the ftn * 3St person to finish with it removes it. 
shared-mem P " g system a,lows only the user who owns a 
a difF 0I ^ Segment t0 re move it from the system. Therefore if 

=* is -- 

"oS’wtf Z P » iC 1- 0n -' eXiK because 0f a si *" al ora memory 

ISAM filis, then 

TL w lZTr~ c,ly , ne sa,us ° f,he ^ mech 

semaphores can J IrthTw ^ "T ? 7 or 
your SCO ITMTY c CII, uvea oy the lpC rm program. Refer to 

SS™ Refer '" ce for « 

8.4 Open File Limits 

library ’ 3 maximum of 10 separate SCO ISAM files 
TvsicalT ^ ° ne K time ' H ° WeVer ’ il 15 possible 1° open a single 
S dir IT' than ° nCe and ’ theref0re ’ t0 ««ss the sam 11 

nS“a " " " — h k - 
i^iTcks COrd IOCkS * the “ 
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New and Revised Manual Pages 


New and Revised Manual Pages A-1 
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A.l New and Revised Manual Pages 

Section:° Win ^ " d revised ma " ual ™ -eluded in ih.s 

Revised pages: 

intro(K) 

tty(K) 

vas(K) 

codeview(CP) 

New pages: 

clrbuf(K) 

nmi(K) 

sigsetv(S) 

catgets(S) 

catopen(S) 

dumpmsg(CP) 

gencat(CP) 

iconv(CP) 

mar(CP) 
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INTRO (K) 

Intro _ 

lists manual page references 

Description 


intro (K) 


?found Cti0n deSCribCS 11,6 manual P a ® e -hich each kernel routine 

iSicS l0 the n roSi!ie the k , ernel routines - 1116 columns 

appears, a description, and a code thTindffes 2 Zu£* g \Z™ 

Letter ' '* ’ 


B 

C 

G 

I 

X 

M 

A 


Meaning 


Use this routine only in a block driver 

Use this routine only in a character driver 

USCd ln a bl0ck 0rcharacter driver 
Can be called from an initialization routine 

Macro Ca ed from 8X1 interru P t routine 

Written in Assembly language 


The section (K) routines 


are summarized in the following table: 


Kernel 

Routine 


Manual 

Page 


Description 


Code 


alMo 

bcopy 
bdistributed 
brelse 
btoc 
btoms 
bzero 
canon 

candoio 
clrbuf 
cmn_err 
copyin 
copyio 
copyout 


all_io 

bcopy 
bdistributed 
brelse 
btoc 
btoc 
bzero 
canon 

can_doio 
clrbuf 
cmn^err 
copyin 
copyio 
copyin 


Determines if all processors can do I/O 

Copies bytes in kernel space 
Allows multiprocessing 
Releases a block buffer 
Returns number of pages (clicks) 
Returns number of sectors 
Sets memory locations to 0 (zero) 
Processes raw input data from a ttv 
device J 

Sees if current CPU can do device I/O 
Zeros a block I/O buffer 
Displays message or panics the system 
Copies bytes from user to kernel space 
Copies bytes to/from physical address 
Copies bytes from kernel to user space 


GI 

GAIX 

BI 

B 

GMIX 

GMIX 

GAIX 

CA 

G 

BIX 
GIX 
GA 
G 

GA 
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Passes character from user space 

Returns number of bytes 
Allocates physically contiguous 
memory 

Frees physically contiguous 
memory 

Transfers data from kernel virtual 
to physical address 
Transfers data from physical to 
kernel virtual address 
Delays process execution for 
specified time 
Prints message on console 
Adds block I/O request to 
device’s queue 

Returns TRUE if screen displayed 
Allocates a DMA channel 
Sizes request into 512-byte 
blocks 

Begins DMA transfer 

Sets up a DMA controller chip for 

DMA transfer 

Releases previously allocated 
DMA channel 

Returns bytes not transferred for 
DMA request 
Begins DMA transfer 
Checks for EISA bus 
Gets EISA ROM data 
Duplicates channel mapping 
Disables mapping on a channel 
Flushes the translate lookaside 
buffer 

Gets a character from user data 
space 

Gets a 32-bit word from user data 
space 


G1 
G 
G 
G 
B 

BX 

CIX 

GIX 

B 

GIX 

GIX 

GIX 

G 

G 
G 
G 
G 
G 

GAIX 
GA 
GA 
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Kernel 

Routine 

Manual 

Page 

Description 

Code 

getablk 

getc 

getcb 

getcbp 

getcf 

getchar 

geteblk 

inb 

ind 

inw 

intralloc 

iodone 

iowait 

ktop 

lockb 

longjmp 

major 

makedev 

memget 

minor ] 

nmi i 

outb i 

outd i 

outw ii 

geteblk 

getc 

getc 

getc 

getc 

getchar 

geteblk 

inb 

ind 

inw 

intralloc 

iodone 

iowait 

ptok 

lockb 

longjmp 

major 

major 

memget 

major 

nmi ] 

nb 1 

nd y 

c 

nw > 

c 

Gets empty buffer from free list 

Gets a character from a clist 

Gets cblock from clist 

Gets characters from a clist 

Gets a cblock from free list 

Gets one character of input 

Gets empty buffer from free list 
Reads a byte from an I/O address 
Reads double words from an I/O 
address 

Reads a 16-bit word from a phv- 
sical I/O address 

Returns MPX handle 

Signals I/O completion 

Wait for I/O completion 

Returns physical address from 
kernel 

Locks critical code section 
Restores previously saved pro¬ 
cess context 

Returns major number from the 
device number 

Returns device number from 
major and minor numbers 
Allocates contiguous memory at 
initialization 

Returns minor device number i 
from the device number 

Detects a non-maskable interrupt < 
Writes a byte to an I/O address < 
Writes double words to a phvsi- ( 
'al I/O address 

Writes a 16-bit word to a phvsi- ( 
al I/O address P y 

B 

C 

C 

c 

c 

G 

B 

GAIX 

GAIX 

GAIX 

G 

BIX 

B 

GMIX 

G 

GA 

GM 

GM 

GI 

GM 

3IX 

3AIX 

3AIX 

jAIX 
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Kernel 

Routine 


I Manual 

Page 


Description 


Code 


paddr 

panic 

passe 

physck 

physio 

pio^breakup 

printefg 

printf 

psignal 

ptok 

putc 

putebp 

putcb 

putef 

putchar 

repinsb 

repinsd 

repinsw 

repoutsb 

repoutsd 


epoutsw 


paddr 

panic 
epass 
physio 
physio 
piojbreakup 

printefg 

printf 
psignal 
ptok 

putc 
putc 
putc 
putc 
putchar 
repins 

repins 

repins 

repins 

repins 


repins 


5 i_get_ge n _ c, nd scsi 

•_I c/'ci 


si_getdev 

:si_mkadr3 

:si_s2tos 

:si_s3tol 

csistok 

csi swap4 


scsi 

scsi 

scsi 

scsi 

scsi 

scsi 


Returns virtual address pointer 

to block data 
Halts the system 
Passes character to user space 
Verifies I/O request size 
Performs physical I/O 
Breaks up programmed I/O 
requests 

Displays driver initialization 
message 

Print a message on the console 
Sends signal to a process 
Returns kernel address from 
physical 

Puts character on clist 

Puts characters on clist 

Puts cblock on clist 

Puts cblock on free list 

Prints a character on the console 

Moves bytes to memory from 

I/O address 

Moves words to memory from 
I/O address 

Moves double words to memory 
from I/O address 
Moves bytes from memory to 
I/O address 

Moves words from memory to 
I/O address 

Moves double words from 
memory to I/O address 
Fills a command block 
Gets SCSI device number 
Makes 3-byte address 
Converts 2 bytes to short 
Converts 3 bytes to long 
Converts 3 bytes to address 
Swaps 4 bytes 


BIX 


GIX 
G 
B 
B 
B 

GI 

GIX 

CIX 

GMIX 

C 

c 

c 

c 

G 

GA 

GA 

GA 

GA 

GA 

GA 

GIX 
GIX 
GIX 
GIX 
GIX 
GIX 
GIX 
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Kernel 

Routine 


selfailure 

selsuccess 
selwakeup 
seterror 
signal 
scsistol 
sleep 
splO 
spll 
spI2 
spl3 
sp!4 
spl5 
sp!6 


spl7 

splbuf 

splcli 

splhi 

splni 

splpp 

spltty 

splx 

sptalloc 


sptfree 

startio 

strcat 

strncat 

strcmp 

strncmp 

strcpy 

strncpv 

strlen 

strchr 

subyte 

suser 

suword 


Manual 

Page | Description 


select 

select 

select 

seterror 

signal 

scsi 

sleep 


spl 

spl 

spl 

spl 

spl 

spl 

spl 


spl 

spl 

spl 

spl 

spl 

spl 

spl 

spl 

sptalloc 

sptfree 

startio 

string 

string 

string 

string 

string 

string 

string 

string 

subyte 


suser 


suword 


Fails condition u 

Okays condition q 

Okays failed condition g 

Sets u.u__error with error code G 

Sends a signal to a process CIX 

Converts 4 bytes to long GIX 

Suspends processing temporarily G 
Fermits all interrupts GAIX 

Blocks context switch interrupts GAIX 
Blocks level 2 interrupts GAIX 

BlorS I 6 "®! a interTUptS °AIX 

Blocks level 4 interrupts GAIX 

Blocks block device interrupts GAIX 
Blocks character device and the GAIX 
clock’s interrupts 

Blocks all interrupts GAIX 

Blocks buf access interrupts GAIX 

Blocks clist access interrupts GAIX 

Blocks all interrupts GAIX 

Blocks network interrupts GAIX 

Blocks ports board interrupts GAIX 

Blocks tty interrupts GAIX 

Enables previous spl level GAIX 

Allocates temporary memory or GI 
maps a device into memory 

Releases memory previously alio- GI 
cated with sptalloc 

Runs xxstart routine g 

Appends strings GIX 

Appends strings of n characters GIX 

Compares strings GIX 

Compares strings of n characters GIX 
Copies strings G IX 

Copies strings of n characters GIX 

Returns string length G IX 

Returns character position GIX 

space* 3 Character 111 user data GA 

Determines if current user is the G 
super-user 

Stores a 32-bit word in user data GA 
space 


Code 
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Kernel 

Manual 

Routine 

Page 

timeout 

timeout 

ttclose 

tty 

ttin 

tty 

ttinit 

tty 

ttiocom 

ttiocom 


ttiwake 
| ttopen 
ttout 
ttowake 
ttrdchk 
ttread 
i ttrstrt 
ttselect 
tttimeo 
i ttwrite 
ttxput 
| ttyflush 
I ttywait 
unlockb 
untimeout 
vasbind 
vasmalloc 
vasmapped 
vasunbind 
i viddoio 
vidinitscreen | 
vidmap 
vidresscreen 
vidsavscreen 
vidumapinit 
vidunmap 
vtop 


Des cription 

Schedules a time to execute a rou 
tine 

Closes access to tty device 
Gets data from receive buffer 
Initializes line discipline 
Interpret tty driver I/O control 
commands 

Awakens input requests 
Opens tty device 
Puts data into transmit buffer 
Awakens output requests 
Verifies characters to read 
Copies tty data to user space 
Restarts tty access 
Ensures read or write without block 
Times input request 
Copies data from user 
Puts data into output queue 
Releases queue contents 
Waits for UART to drain 
Unlocks critical code section 
Cancel scheduled timeout request 
Binds virtual address to physical 
Allocates virtual user memory 
Releases allocated memory 
Unbinds bound memory 
Supports I/O controls 
Initializes multiscreen 
Maps memory 
Restores screen 
Saves screen 
Maps user memory 
Unmaps memory 

Convert a virtual address to a phy¬ 
sical address 

Wakes up a sleeping process 


GX 
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tty: ttclose, ttin, ttinit, ttiwake, tto- 
pen, ttout, ttowake, ttrdchk, ttread, 
ttrstrt, ttselect, tttimeo, ttwrite, 
ttxput, ttyflush, ttvwait 

tty driver routines 


Syntax 


include "sys/types.h" 
^include "sys/tty.h" 

int 

ttclose(tp) 
struct tty *tp; 

int 

ttin(tp, code) 
struct tty *tp; 
int code; 

void 

ttinit(tp) 
struct tty *tp; 

int 

ttioctl(tp, cmd, arg, mode) 

struct tty *tp; 

int cmd, arg, mode; 

void 

ttiwake(tp) 
struct tty *tp; 

int 

ttopen(tp) 
struct tty *tp; 


int 

ttout(tp) 
struct tty *tp; 
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void 

ttowake(tp) 
struct tty *tp; 

int 

ttrdchk(tp) 
struct tty *tp; 

int 

ttread(tp) 
struct tty *tp; 

void 

ttrstrt(tp) 
struct tty *tp; 

void 

ttselect(tp, rw) 
struct tty *tp; 
int rw; 

void 

tttimeo(tp) 
struct tty *tp; 

int 

ttwrite(tp) 
struct tty *tp; 

void 

ttxput(tp, ucp, ncode) 
struct tty *tp; 
int ncode; 
union { 

unsigned short ch; 
struct cblock *ptr; 
} ucp; 

void 

ttyflush(tp, rdwrt) 
struct tty *tp; 
int rdwrt; 

void 

ttywait(tp) 
struct tty *tp; 
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Description 

The routines are: 


ttclose 


ttin 


ttinit 


Called by the line discipline zero l_close routine to 

„^°, ve . acces . s to * tt y device from the process that 
called it. ttclose disables ISOPEN from the t state 

r nrmsp f the tty structu re, calls ttioctl with the 
LDCLOSE argument, and disables XCLUDE from the 
t_Iflag member of the tty structure. 

CaHed by the line discipline zero IJnput routine to 
HrivPr’f aC | erS fr ° m 3 TTY device - ttin is called in a 

acters fmmT t K° f Utlne u pr0CeSS 311(1 move char " 
t Iaw« f » - rbuf to u *e raw character queue, 
Un P rocesse s the termioQA) c cc values of 
vE’ VgWTC »’ VEOL, VERASE, 

TTANnw^ d VE °u’ 111 addltlon > ttin checks that 

vttmp^ ! S SCt when P rocessm g the c_cc VMIN and 
VTIME values, ttin performs input escape mapping 

for mtemationahzanon character processing If the 

STrmT gUmei i lt t0 n n is L - BREAK - ttin sends the 
SrcDMT signal to all associated processes, ttin then 

calls tty flush to release both read and write buffers 
ana returns if no characters are found in t rbuf If 
either ECHO is set or after processing international 
character mapping, ttin calls the driver’s xxproc rou¬ 
tine with T.OUTPUT set. xxproc can also be calTed 

NOFLSH S r? H KfH if VSWTCH is “^led and if 
disabled, ttin calls these other tty rou- 
tines: ttyflush, ttxput, tttimeo , and ttiwake. 

struc ture for line discipline 0 

S w,2^f°™ 8 n “ mbers of "" '•> 


• tline line discipline index is set to 
0 (zero) 

• terminal input control is set to 
0 (zero) 

• toflag terminal output control is set to 
0(zero) 

• Ufog ^— line discipline terminal control is 
set to 0 (zero) 
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ttioctl 


ttiwake 


ttopen 


• t cflag — terminal hardware control is set to 
these values: 1200 baud (SSPEED variable), 8 
bits (CS8 variable), enable receiver (CREAD 
variable), hang up on last close (HUPCL van- 
able) 

Used to allocate, deallocate, or move the contents of 
terminal buffers. Called through the Ijoctl function 
of the line switch table. The and argument to ttioctl 
has the following values: 

• LDOPEN — allocate a receive buffer, initial¬ 
ize several t rbuf members (c_ptr, c_count, 
and c_size), and call the driver’s xxproc rou¬ 
tine with T JNPUT as the argument. 

• LDCLOSE — call the driver’s xxproc routine 
with the T_RESUME argument; call ttywait to 
wait for data to clear the UART; and call 
ttyflush to empty the t_canq and t rawq 
buffers, as well as the contents of t_rbut. 

• LDCHG — move contents of the raw queue, 
t rawq, to the canonical queue, t_canq. 
LDCHG only works if ICANON is enabled. 

Called from an interrupt routine to wake up any pro¬ 
cesses that are asleep waiting for characters to 
appear in the raw input queue, t_rawq. ttiwake only 
works when IASLP is set in the t_state field of the 
tty structure, ttiwake disables IASLP. 

Called on each device open to initiate access to a tty 
device. Determines the process group leader and 
then opens a tty device for I/O. This routine requires 
user context and cannot be called from an interrupt 
routine. The verification of the process group leader 
includes a check to determine if the device was 
opened with the POSIX FNOCTTY extension. If 
FNOCTTY is not specified when the device is 
opened, then the process wants to have acontrolling 
ttv assigned by ttopen. Conversely, if FNOCTTY is 
specified on the open, then the process is nagged to 
not have a controlling tty. FNOCTTY is defined in 
sys/file.h and is sent by the kernel to an xxopen rou¬ 
tine as an open file flag. 

If the process is the process group leader and a con¬ 
trolling tty is requested, then u.u_ttyp is set to the 
address of the t_pgrp field in the device’s tty struc¬ 
ture, and tpgrp is set to the processes p_pgrp 
value in the proc structure. The user structure is 
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ttout 


defined iiTsys/proch!* 1 ^ PWC Structure is 

lnS Ve , su Per user control is requested with 
nrp LU ? E Se J “ U fla s> dien all other open requests 
are returned with EBUSY set in u.u error 5? 

LDOPEN to C r °P en ’ ttioctl is call ed with 

LUOPEN to open the device. After this sten con 

eludes, t state is cleared of a previously set WOPEN 
value and ORed with ISOPEN. * 

Gets next packet of characters from the t outq out- 
put queue and moves them to the t tbuf transmit 

is c f ai r ied r from Ut a i 0 th t e devke ' 71115 routine 

is caned from an interrupt routme. ttout performs 

iming to wait for packets to be received if*a delay 

value is set in t_schar. This value is either FALSE if 

cTolrSs" Th? ■ ° r f' ? a tutor of 

is decimaVfi ° f tlCks ^ Can ** specified 

6 1 \ 33 - ttout ensures this range bv AND- 
mg the specified value with octal 0177 and then add 

£? rfPV'T 1 5 nl ' d ““"al «X *« „um. 

J’f* °f dock ticks that occur in a second. This value 
s contamed in the manifest constant HZ. 

If characters are not found in the t outa outnnr 
queue and if t_state contains TTIOW, then wake-up 

Sre LT ,tm £ f °^ ° Utput t0 the terminal to drai n P 
iW f on Thf m L the S ee P ing Processes (that are sleep- 
mg on the address of tp->t_ofiag), ttout disables 


LSjg de fe^C SSin or iS r qL f t ted by ‘- S ‘ ate 

EXTDlY 8 or t Jn OC ’ 0r t - xstate containing 
, or t oflag not containing OPOST then 

fer TheTtheTc 1 15 ? erfo ™ ed ^aracter by charac¬ 
ter men the c_count, c_size, and c ptr fields of the 

Mock structure contained by tjbuf ire set respec¬ 
tive to the number of bytes moved. When character 
timing is in effect, the character taken from the out- 

Sf? r*£ k ' d “ if * greater toZ 

value or the QESC constant. If the character ic 
greattr to QESC. to Ihe character is a 


,, dlc . f, ounl of the characters in the output queue 
ite ™altd. WMt to 


ttout returns the 
100000—defined 
to indicate further 


vaiuc ui Uf-Kfci) (typically octal 
in sys/tty.h) when EXTPROC is set 
processing needs to be handled by 
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ttowake 


ttread 


ttrdchk 


ttrstrt 


ttselect 


tttimeo 


the controller, or when OPOST is set to indicate Aat 
further processing needs to be handled y 
ware. If neither of these flags are set, zero (0) 
returned. 

Called from an interrupt routine to walte up any pro^ 
cesses that are asleep waiting for characters to 
appear in the output queue, t oiitq. rrowafcf on y 
works when OASLP is set in the t_state field of the 
tty structure, ttowake disables OASLP. 

Called from a driver’s xxread indirectly 

through the Ijead line discipline switch func P°^ 
ttread conveys characters processed by canon from 
the canonical queue, t_canq, to the user process. 

Returns a non-zero value if there are characters to be 
read. If carrier is present (CARR ON is enabled m 
t state), ttrdchk tests t_canq for characters. t_canq 
is the queue for characters that have been processed 
by the canon routine. If characters are P rese ^ t ’ al 
returned. If characters are not present, and canon is 
being used to process characters from the temunal 
(ICANON is set in tjflag), then ttrdchk tests the de¬ 
limiter count to see if a delimiter has been entered 
the tty device. The delimiter count is held m t delct 
in the tty structure. If a delimiter was received, 1 is 
returned* If characters are not present, but canon is 
not being used to process characters, then the raw 
SiSr 8 queue. t.Vaw,, is checked for characters 
If characters are waiting in the raw queue, 1 is 
returned. 

Restart tty device output after a delay timeout. 
ttrstrt performs only one task; it cal ls th | dnver s 
xxproc routine with arguments of tp and TJnME.((p 
is die pointer to the tty structure passed through from 
the argument to ttrstrt.) 

Ensure that a read or write can be performed with no 
blocking. (If blocking occurs, the process will be put 
to sleep until the VO can be satisfied.) Do not ca 
sleep! K) before calling ttselect, and do not call 
ttselect from an interrupt routme. »^^' bas two 
modes determined by its rw argument. These modes 
are SELREAD and SELWRITE. 

Satisfy VTIME timing requirement for data input. 
tttimeo does not execute if ICANON is set, if VTIME 
or VMIN are not set, or if there aren t any characters 
to process in the raw queue, t_rawq. tttimeo calls 
timeout(K ) for the time specified m VTIME times the 
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number of ticks per second (Hz) divided by 10 

Md TArr ° wi S act L ve ’ t - state is ORed wi[ h RTO 
Slled m L a ?? en the tlming fmishes - ttiw °ke is 
.heraw inputs„r Proces “ s ' h *' « keeping on 

^a^nWc* 6 Hne disci P line 1 -write function call 
m a driver s xxwrite routine to copy data from the 

dknif r °H ram 11110 the driver so 11131 the data can be 
displayed on a tty device. If there is no carter 

context ST T medlate] y- ttwrite squires user 
context and therefore cannot be called from an inter- 

ing to 0 get n Siedam P f 8in8 f3Ult ° CCUrs while attem P'- 

to 8 FFA 8 i n -? i d fu fr0m user space > u u _error is set 
to EFAULT. In the course of the codv ODeration 

u.u_base and u.u_count are updated to reflect the 
amount of data transferred, ttwrite calls ttxnut tn 
wnte the data to the terminal. P t0 

?htSte d r? a in S m tChe ^ fr ° m USer space ’ the numb er of 
characters in the output queue, t outq, are checked 

hiotf 6 cou ? 1 excee ds the high water mark The 
high water mark is the point at which tty inpu is 
suspended s° that the characters coming in don‘ 

ech? them fo tty ^ abilit y t0 Pattern aSd 

water m a Tk ?hpH PUt ' ^ the count exceed s the high 

the i SuTPlS dnV£rSX17 " W routine is calIed w hh 
me 1 -OUTPUT argument, and the process is out to 

sleep until the tty driver can handle I/O agai n P The 

of TTOPRwS 11 the address of t_oufq at 8 priority 
of TTOPRI (above PZERO) and can be awakened 

3 Sign , 3L U 3 Signal f semTo fte 

controllo dieran’ 3 on8jmp< - K) occurs, returning 
to the calling user process and putting EINTR 

!n mV rr , 0r (errno in use r space). If Swrit! oS 
m the background, SIGTTOU is sent to all processes 
in the current process group. p sses 

Puts characters on the tty output queue (t outa) 

rernm t'r’ e f- pands tabs ’ “ d handles clSe 
return Md new line characters, ttxput is called from 

and h f base - evel t0 output characters to a tty device 
and from interrupt level for echoing characters read 

££s Sr«g** 3 - « queue 

oumut auene ^ detected it ,s put directly on the 
tr % , Queue. The next character after OESC is 
treated as a timer character if the octal value is 
greater than 200. The timer character is used in a 

istesslhan 200 ?t *°T' character after QESC 

to beoJjjJt ’ ,S 35 30 ° Tdinary character 
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ttyflush 


If t state contains EXTPROC, but t_lflag does not 
contains XCASE, then no post processing Required. 
Additionally in this state, characters can be interna 
tionally mapped if requested, and 
put queue for further processing.^ XC ASE mdica 
diat special characters should be escaped b> being 
whh a backslash. Refer .0 f« a 

list of characters that are translated when XCASE s 
specified International character mapping 
requested iff mstate is true. If XCASE processing is 
re?Sd, then international character mappmg can 

also be requested, and processing for QESC is avail 
able (QESC handling is not available when no p 
processing is required). 

ttxput processes characters with octal values greater 
than 200 as special characters ^ Performs delay 
processing if t state does not contain EXTPROU 11 
EXTPROC is set, than delay processing is ass ^ e 
be handled by an external process. Characters tha 
may require translate and also need to mdicate a 
delay are shown in the following table. 


Octal Value 


- Sior" 

non-pnnting character 

0202 

backspace 

0203 

line teed 1 

0204 

tab 

0205 

vertical tab 

0206 

carnage return 

0207 

form teed 


If delay handling is being provided by ttx P ut ’ ^ 
the delay is calculated based on the value of t_oflag. 
Ke routine does .he actual toed deg- 
outputs the QESC character as well as the timing 
value ORed with octal 0200. 

Called to release character blocks to die free list 
from the write buffer, t outq, or from the two read 
buffers, t canq and t_rawq. The r^ a^me 
ttvflush should be ANDed with either FREAD to 
release read buffers, or with FWRTTE to release the 
write buffer. When the blocks m the write buffer are 
released, the driver’s xxproc routine is called with 
the T_WFLUSH argument. If t_state contains 
OASLP any processes sleeping on the addres 
t outq are 1 awakened and OASLP is disabled audit 
rSe contains mow, then TTIOW «. toabled tmd 
all processes sleeping on the address of t_oflag are 
awakened. 
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ttywair 


TTY (K) 

tL^fhi°H kS the read buffers "* bein g released, 
TPmicu nVer S xxproc routine is called with the 

iasip^c H ar ^ n l ent J If *- state contains !aslp, 
IASLP is disabled and all processes sleeping on 
t_rawq are awakened. K 

Called to drain the contents of the universal asyn- 
clu-onous receiver/transmitter (UART). ttywait waits 
1 bit times for the UART to empty of all data. The 
baud rate is taken from t_cflag&CBAUD and possi- 
ble values are (in bits per second): 0.5,50 75 110 
134, 150, 200, 300, 600, 1200, 1800 2400 480o’ 
®“°- 19200. or 38400. If upon STVoudS 

a [ e ln t outq, or t_state contains BUSY or 
TIMEOUT, then t_state is ORed with TTIOW and the 

TTOPRI 1 S 'rrnPRT Sl h ep ° n address of Loflag at 
rTOPRL TTOPRI has a value above PZERO and 

ShnniH r f Can P remature ly awakened by a signal. 
Should a signal occur, control returns to the user pro¬ 
gram and the EINTR error code is placed in 
u.u_error and errno in the user program. 


Parameters 


tp 


code 


A pointer to the struct tty data structure 
associated with the device beirn- 
accessed. 


Used by ttin and can be set to LJBREAK 
to cause all processes associated with 
the terminal to be sent a SIGINT signal 
and to have all character blocks on 
t outq, t canq, and t rawq queues be 
released to the free list. 


cmd, arg, or mode 


rw 


ucp, ncode 


Used by ttioctl to determine which I/O 
control command is being requested. 

Used by ttselect to determine whether 
the driver is testing for read or write 
access without blocking. Possible 
values are SELREAD or SELWRITE. 

Used by ttxput. ucp describes a union of 
a character or a pointer to a block of 
characters ncode is a flag used to indi¬ 
cate which value ucp contains; if ncode 
is zero (0), ucp is a character; any other 
V h| Ue J nd ' CateS tbat ucp * s a Pointer to a 
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rdwrt 


Used by ttyflush to indicate which 
buffers to release to the free list. AND 
with FREAD to indicate that the cblocks 
in t canq and t_rawq should be 
released; AND with FWRITE to indicate 
that the blocks in the t_outq should be 
released. 


Notes ___— 

All routines on this manual page can be used only with character de- 
vice drivers. 


Return Values 


Only ttout, ttrdchk, and ttread return meaningful values. These values 
are described as follows: 


Routine 

Value 

Event - 

ttout 

0 

Hither a delay was satistiea or an 

characters have been moved from 

t outqtot tbuf 

0100000 

(octal) 

When external processing is 

requested by EXTPROC to be 
handled by a hardware controller, 
or by OPOSTtobe 
handled bv the software. 

ttrdchk 

0 

All characters have been read 

1 

1. If characters remain to be react 

2. If no characters are in t canq 

3. If canonical processing is 

requested and a line delimiter 
has been received. J 


The following routines are cast 
return values are indeterminate 
and ttwrite. 


as having an int return 
: ttclose, ttin, ttioctl, 


value, but the 
ttopen, ttread , 
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The u.u_error field is set under the following 


TTY(K) 


circumstances: 


Koutine 

ttioctl 

Value 

~ EINVAET 

Event - —- 1 

An improper cma argument to 

ttioctl was specified 

ttopen 

bBUSY 

A process trying to open a tty device 

is not super user and XCLUDE 
is set in tp->t lflag 

ttread 

fcTAULT 

Copying data to user space failed 
during a copyout( K) or 
subyteiK) call 

uwrire 

i _ 

JbhAULT 

1 • .copying data from user space 

failed during a copying K) 
orfubytefK) call 

2. A negative number was detected in 
-received from user spar* 


See Also 


termio(M), canon(K), ttiocom(K) 
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codeview 

visual debugger 

Syntax 


cv [options] [executable_file [arguments]] 

Description 


"m "-. can opera, c in 

interface. In window mode h™ ( senal) mode , for a simple line 
offer fas, access ,o mos, commoll coZS” S ‘ mpl ' keys,rokK 

KSSng Sr“ functions, codeview per- 

process text and data/codeview c^^ehim 31 ” 1111118 311(1 modifyin 8 

EKSsTffi^S^ 1 ’ 8 core r,les 

generating symbohcTbugl ^linl ^ °Ptions for 

should at leasT have a sta^d^d IS re , c ? rds - 71,6 executable 
not be stripped). Otherwise tab e (tJ ? e exec utable should 

level debugging without svmhni 1CW ony P rov *de assembly 

dlbuj S S ipIo n m ^,“' e c > o°Z?, e Z^rF 1 ' 5 ' 0 w^na^ 

w,d,u p iew % srff,rr»s 

^rinlfc^fdte^tZLT 5 fW nme<J 

^.5»J^r.S?. view • «*KX*S2i£ 

&szstjizsss “a* sizs*** -» 

V.ew ,s running, arguments can be reseTnsbigT (restart)^ 
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CodeView takes the following options: 

-c command-list 

Execute comand-list on startup. 

-t Run in serial mode. 

-C corefile ^~ ^ fik corefik Use _ c „ t0 ign0 re core in the 
current directory. 

-b Specifies a monochrome (black & white) display, 

volume titled The CodeView Debugger . 
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Command Syntax 


CODEVIEW (CP) 


Tile 

open 
shell 
exit 

view 
source, mixed, 
registers 
local/watch 
output 


I search 
find 

next, previous 
labe l 

| run 

start 
restart 
execute 
clear breakpoints 
| watch 
add watch 
watchpoint 
tracepoint 
delete watch 
delete all watch 


Bet^' e, “ ai ' f0rVieWi ” S 

exit codeview 

assembly select source mode 

toggle register window 
toggle local/watch window 
---toggle to p rogram output 


I options 

save output 
bytes coded 
case sense 


language 

auto 

basic 

C 

fortran 


calls 

stack 

backtrace 

window 


help 

variet 


of heir 


search for regular expression 
use last regular expression 
goto text label 


re-load and go 
re-load 

slow-motion execute 

J gmove all breakp oint 

add watch expression 
add watchpoint 
add a tracepoint 
delete watch expression 

w " ch >*' i " K and 


toggle fiip/swap option 
toggle assembly mode verbosity 
__toggle s ymbol case sensitivity 


la Ml sc™ node, tendon Keys perfonn fc f„ Uowilg op e rati o„ S : 


May 1, 1990 


CODEVIEW-3 








































CODEVIEW (CP) 


CODEVIEW (CP) 



[FT 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
F10 
F12 Menu 


Toggle between source and dialog window 

Go to cursored line 

Trace (e.g. into functions) 

Toggle breakpoint at cursored line 
Step (e.g. over functions) 
selection 


Coveview 


understands the following special keystrokes: 


Special Keystrokes 

commas line 

Menu selection 
Local/watch window toggle 
Find regular expression 
Add watchpoint 
Delete watchpoint 


L 
ESC 
HOME 
END 

<alt >letter 
<shift>F2 
<ctrl>F 
<ctrl>w 

<ctrl>u 

Dialog commands use the following syntax. 
command[arguments][', command] 

Dialog comands are no, ear. sensitive. Symbol names may be case 
sensitive. 

“ea'tr'mo'tTo— 

valid: 


Address Constructs 

symbolname 
[@]register 
[segment:]offset 
startaddress endaddress 

Z'-aflreZ (^“'default eounl, usual, 128) 

line, number rename :!linenumber 


Several cc^view comma^^^e exproaoi^asju8urnents.^Expres- 
sions can be complex C exp . ® eva i ua tion corresponds to 

S5£ — ” s 
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Constants use the following syntax: 
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Constant Syntax 

digits 

default radix 

0 digits 

octal 

0 xdigits 

hexidecimal 

On digits 

decimal 

"chars" 

-_jQldj_terniinated string 


oveirides Kgt “Ti' TIT* “ t & sym ^i 
“sing (eSpte @S5: ““ case - lhe re 8 isKr =“ I* specified 

name^for'adcpessmgm'steajiofbrackets^ ” ** " se<i wilh re « is "' 

BY 
WO 
DW 


byte pointer 
word pointer 
double word pointer 


For example, WO si+bp+6 is equivalent to WORD PTR [si][bp+6j. 

Code Display 


The following table lists the commands that are used to view code: 


Code Display HI 

*uurce mode 

view source 


5 [+J-I&] - - 

+ C source 
- assembly 

6 mixed 

with no operand, 
displays current mode 

v [address I 

ocaiLii lor regular expre.™inn 

Move in tne source window 

unassemble code “— 

(regular^ expression 

SJgup>, <pgdn> 

arrow keys 

HOME, END 

— u \dddress 1 ranee I 
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CODEVIEW (CP) 


The following commands display data: 

1. lexpression[format] 

This table lists the valid format specifiers: 


d, i 

u 

o 

x,X 

f 

e, E 

g> G 

c 

s 

h 

1 


For mat Specifiers _ 

signed decimal integer 

unsigned decimal integer 
unsigned octal integer 
unsigned hexadecimal integer 
floating point 

scientific notation floating point 
scientific notation floating point 
character 

null terminated string 

used with d,o,u,x and X. Example: ,hd (short) 
iiMri with d.o.u.x and X. Example: .Id (long) 


2. llexpression 

The following special keystrokes are recognized: 

<retum> de-reference current object 

<esc> return to dialog line 

3. r [register] 

This causes a register dump; without a register name, it shows all 
registers and disassembles the current instruction at cs.ip. 

4. 7 


Math co-processor register dump. 
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Variable and Memory Assignment 


CODEVIEW (CP) 


Use the following commands to assign value s to variables or registers: 

Variable & Memo ry Assignment 

nn = _ _r s ---- - 


^expression = expression 
Tregister [value] 


Left expression mult 

evaluate to an lvalue 


Assign value to indP 

cated register. If value 
is omitted, prompt for a 
new value. 


Special Commands 


The D (Dump) commaud displays memory contents, and uses Ihis sy„. 

D [^pe] [address\range] 

The following types are recognized: 


Types 


iB bytes 

A ASCII characters 

I two-byte integers 

w “ nsi ? ned tw o-byte integers 

W two-byte words, hexadecimal 

U four-byte words, hexidecimal 

f short reals (four-bytes) 

C long reals (eight-bytes) 

1 tgn-bvte reals 


J 


the diffe ( ren?e^Use°S^nt^ mPareS tW0 memory regions and lists 
C range 1 address2 

s range list 

The E (Eme,) command modifies memory comer®, and uses this syn- 
E ltype] address [list] 
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CODEVIEW (CP) 

The F (Fill) command sets meow cements to and iterated pattern, 
and uses this syntax: 

F range list 

The M (Move) command copies memory contend, from one region to 
another, and uses this syntax: 

M rangel address2 

The A (Assemble) modifies a text range using a dynamic assembler. 
This is the syntax: 

A [ address ] 

Execution control ___— 


g [ address J 
t \count] 
p [count] 

Execution Control_ 

- Ppcnme execution (go)- It provided, go_loaddress_\ 

‘ Program; single-step; step over Wuun calls 
atomic). 

e 

[args] 

“Slow motion 7 ’ execute. ----——-7“ 

RestarT(ioad). Uses command lme argument *1 

specified.a, , », hgr , PV Hi 

sig [signo] 

Set pending signal; signal will take effect^wh 

cution is resumed with g, t or p. Without signo, 
Hkplav currently pending signal. 


W&ddTessti^unt] [corr^dsW S ^' break p oint ( s ) 

be [list I J bst breakpoints 

bl enable breakpoint(s) 

be [list * ] di ^hlp hreakpoint(s) 

hd r list 1*1, 
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I—,_ Watch, Watchpo ints, & Tracepoints- 

watch expression- 

P- xpression[format] set watchpoint 

tp- expression [ format] set tracepoint 


Redirection Commands 


watch, watchpoint and tracepoint list 
watch, wathcpoint and tracenoint 


< filename 

[T] > filename 

=filename 
*comment 


Re-direction commands: * ~~ 

“R^dilTu codeview mput tromfilename'. 

OntS codeview ° ut P u t to filename. 
Optional argument T echos output to 
codeview screen as well as filename. 
Re-direct input and output 
Echo comment text to codeview screen. 
Delay execution of commands by aprox- 
imately 1/2 second. y P 

Pause until keystroke 


Miscellaneous commands 


Miscellaneous commands 


ire a n , ex *t codeview 

'■UheU commands)] shell escape 


h 

<esc> 
n [radix] 

<ctrl>g 

<ctrl>t 

o[blclf][+|-] 


#,number 


redraw codeview screen 
help 

clear command line; cancel menu command 
set defauh input/output radix (8,10 or 16) 
with no argument, shows current default radix 
Ccm” 1 window, e.g. source or dialog 
curr £ nt window, e.g. source or dialog 

following^ ° f P,ay CUITent Status of the 
b - bytes coded 
c - case sensitivity 
f - flip/swap (e.g. save output) 

screen exchange; switch to output screen 
tablet, specify width for tab to space expan- 


Files 


a.out 

core 

/usr/bin/cvtcoff 


May 1, 1990 


CODEVIEW-9 



















































CODEVIEW (CP) 


CODEVIEW (CP) 


/usr/lib/cv.hlp 
/usr/lib/keyboard/ cv 

See Also ______ 

cc(CP), ld(CP), a.out(F), core(F), syms(F), sh(C), cvtcoff(CP), 
adb(CP), sdb(CP) 


Notes 


must be installed for debugging of COFF binanes. 

Only 386 binaries are supported. 

HjESSKsasBSS 

file to the codeview mapping: 

mv Iusrlliblkeyboard/keys lusrlliblkeyboardlkeys.OO 
In / usrllibl key board/ cv lusrlliblkeyboard/keys 

Alternatively, you can use mapkey on the non-default file: 

mapkey lusrlliblkeyboardlcv 

Value Added 


CodeView is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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vas: vasbind, vasmalloc, 
vasmapped, vasunbind 

virtual address space memory routines 


Syntax 



vasbind^paddr, vaddr, nbytes) 
paddr_t paddr; 
caddr_t vaddr; 
unsigned int nbytes; 


caddrt 

vasmalloc(paddr, nbytes) 
paddrt paddr; 
unsigned int nbytes; 


int 

vasmapped(paddr, nbytes) 
paddr t paddr; 
unsigned int nbytes; 

int 

vasunbind(vaddr, nbytes) 
caddr t vaddr; 
unsigned int nbytes; 


Description 


™S<TfS“rwS » V b» r i m a aP / hySiCa i mOT ^ » 1- i' can 

Tl.ese routines ant geHeSnJ S “" d a «“i»» nscrptoce” 

access video adapter memnrv m l ° ^ user Processes to directly 
these routines is visible to tte mapped Using 

ever, the mapping is not globaHy Slfto Si H ° W ' 

ZZf%£%£ iltfcS USe ftiS r ° Utine » **» virtual 
only allocate four meXLTof vL , USe ,, V “ /w cu ^ntly cm 
Requests less tha^^fs Z oun f ^ add f ess s P ace each calL 
requests larger than this amount caused emrfn* 0 f ° Ur ™ gabytes; 
argument exists for forward cnmn/nk^ f t0 occur ne «bytes 
address to virtual user memory- mfcmaPnhJ^T 1100 retums 311 
cated by this routine " 3Ctoa Physical memory is allo- 


July20, 1990 


VAS-1 





VAS(K) 


VAS(K) 


M binds a 

routine ensures that a problem will not occur wim kernel 

already been mapped for the calling process. 

The physical address supplied 10 "^a^ed' Jo'Stas" Or 

s““, S -Ho'SquS EH?« be Stored born d,. kernel free 
memory pool. 

When .dabM completes. <be ^“SefsiSrt^Sus 
S ^SE e no. U 52ibf » address in dre rex,, dare, o, shared da,, 
segments of a user process. 

■me upper ltmi. fr m vindrel metoT* se, in dre^VBASEcon^d 

<* ta ”“ r vlnual 

rmo^CKVBASE). an P f mus, no, be in use by the curren, pro- 
cess. 

vasmapped determines if a mapping is already in place. 
vasunbind undoes a mapping. 


Notes 

---- 

These routines cannot be called from a driver’s interrupt routine 
( xxintr ). 

Parameters 

_ 

nbytes 

number of bytes of memory to allocate, bind, 
or unbind. 

paddr 

Physical address at which the specified virtual 
address is to be bound. When calling vasbind, 
paddr can be set to -1 to indicate that the 
requested user virtual memory is to be alio- 
cated. 

vaddr 

Virtual address to bind or unbind to or from 
physical memory 

Return Value 


vasbind returns 

-1 if an error occurs or if an error is found in 
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if an error is fo^d // ^ C u e u tU ^ror V o tU f 1 th ddr ^ SS ' , vasunbind returns -1 
found, vasmapped retumF the vi*» f Vlrtual address couldn’t be 
Physical 

See Also 


sptalloc(K), copyout(K) 
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clrbuf 

zeros a block I/O buffer 

Syntax 

^include "sys/buf.h" 
int 

clrbuf(bp) 
struct buf *bp; 

Description 


You supply a pointer to a buffer header fbon Tl ? Uring block 1/0 ■ 
trne then zeroes the data 2 h ( , bp) u° ^ clrbuf rou- 

>b.un.b_words for the number of hl t0 by < - the addre ss in bp- 
c/rbw/ also sets bp->b resid to zero (of JrW “ b P'> b -bc 0 unt 
value. The b_words,"b bcount and h r°fi n0t have a return 
the A«/structure and are defined in the bSf.h header fil^ 6 members of 

clei toVbuff $ eteblk does not 

cleared. The geteblk mnim! , • USed t0 ensure that the buffer is 
dard way to call clrbuf h as follow* 3 V3,Ue t0 b - bcount The stan- 


Warning 


b P * geteblk (), 
clrbuf(bp) ; 


Get a buffer 
Clear it 


managed with 

than the size of the buffer. Tfb bcount S ^ * e same or less 
current buffer size, data may be destrovin l *k 3 Va ue lar 8 er than the 
to SBUFSIZE. SBUFSI7F ic s^yed. M coun t is set by geteblk 
by file system size E 15 deSCnbed ln ^/fs/sSparam.h Zd lSil 

See Also 


geteblk(K) 
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nmi 

***** „ 0I ,-maskable intern^ 

Syntax 


extern int nmi hook; 

Description 

STS "«■« 

tcsrrsL^ 

rupted power supply (UPS). f ' 3 r ° Utlne associated within uninte?- 


Note 




^ ss ^s*z !oS m t k ' m "»— * **• 


Warnings 


‘®^uri5te dSte*Sj“ n ' he NMI was 

^asa 
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Example 


This example depicts the following. 


xampie -- ~ 


Assigning a driver routine to l^^^alled to determine if the 
that'an N Sfl occurs with the driver, 

interrupt was raised by the device a 


What a routine is like ^determine if the interrupt should 

line 14. 


line 18. 


int (*previousj 


hook) 0 


bdminit 0 

{ 


extern int (*nmi_hook) 0 -' _ 
extern int bdm_nmr_hookO 



ptevious_hook nmi ho . 

nmi_hook = bdm_nror_hook, 


8 ) 


10 


bdm_nmi_hook(krnl_stack_ P tr) 
int krnl__stack_ptr; 


11 


12 


if (was_that_my_nmi() — TRUE) 


13 


14 


15 


service_nmi () / 

return 1; 


16 


17 


18 


if (previous_hook)^ ev io US _ h o 0 k) ,krnl_stack_ptr) ; 


19 


else 


20 


return 0; 


21 1 
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sigset, sighold, sigpause, sigrelse, 
sigignore __ 

System V signal management 

Syntax 


#include <signal.h> 

void (*sigset(sig, func))() 
int sig; 

void (*func)(); 

int sighold(sig) 
int sig; 

int sigpause(sig) 
int sig; 

int sigreise(sig) 
int sig; 

int sigignore(sig) 
int sig; 

Description 


The functions sigset, sighold, sigpause, sigrelse, and sigignore 
enhance the signal facility and provide signal management for appli¬ 
cation processes. 

pie argument j/g specifies the signal and the argument func specifies 
the choice. The argument sig can be assigned any one of the follow¬ 
ing signals except SIGKILL: 

SIGHUP hangup 

SIGINT interrupt 

SIGQUIT quit* 

SIGILL illegal instruction (not reset when caught)* 

SIGTRAP trace trap (not reset when caught)* 

SIGABRT abort* 
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SIGFPE 

floating point exception* 

SIGKILL 

kill (cannot be caught or ignored) 

SIGSYS 

bad argument to routine* 

SIGPIPE 

write on a pipe with no one to read it 

SIGALRM 

alarm clock 

SIGTERM 

software termination signal 

SIGUSR1 

user-defined signal 1 

SIGUSR2 

user-defined signal 2 


* The default action for these signals in an abnormal process termina¬ 
tion. See SIG JDFL. 

For portability, application programs should use or catch only the sig¬ 
nals listed above; other signals are hardware- and implementation- 
dependent and may have very different meanings or results across sys¬ 
tems. (For example, the System V signals SIGEMT, SIGBUS, 
SIGEGV, and SIGIOT are implementation-dependent and are not 
listed above.) Specific implementations may have other 
implementation-dependent signals. 

The argument func is assigned one of four values: SIGJDFL, 
SIGJGN, SIG__HOLD or an address of a signal-catching function. 
The argument func is declared as a type pointer to a function returning 
void. The following actions are prescribed by these values: 

SIG_DFL Terminate upon receipt of a signal. 

Upon receipt of the signal sig, the receiving pro¬ 
cess is to be terminated with all of the conse¬ 
quences outlined in exit(S). In addition, if sig is 
one of the signals marked with an asterisk above, 
implementation-dependent abnormal process ter¬ 
mination routines, such as a core dump, may be 
invoked. 

SIGJGN Ignore signal. 

Any pending signal sig is discarded. A pending 
signal is a signal that has occurred but for which 
no action has been taken. The system signal 
action is set to ignore future occurrences of this 
signal type. 

SIGJiOLD Hold signal. 
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TTie signal sig is to be held. Any pending signal of 
this type remains held. Only one signal of each 
type is held. 

Otherwise, func must be a pointer to a function. Upon receipt of the 
ignal sig, the receiving process is to execute the signal-catching func- 
Thk oHH lted t0 by fun ? An y Pending signal of this type is released 
H^nc d fl eS L 1S re i ained , across calls t0 other signal management func- 
thp nnfv 8h ° d and sig [ else 1116 si 8 nal number sig will be passed as 
5* ly f 8 ume nt to the signal-catching function. Before entering the 

tesetto Sir 8 Hni C n° n* 6 ValUe ° f funC for ^ caught signal § will 
rfA, MG_HOLD. During normal return from the signal-catching 

andler, the system signal action is restored to func and any held sie- 

If a non-local golo is laken.X taction 

release any“gSlrfthif^ reS “ re *' SySKm si8 " al acti °" “ 

wm fr ° m ,- he si 8 n al-catching function, the receiving process 

will resume execution at the point at which it was interrupted, except 
for implementation-defined signals where this may not be true. P 

a^raVi 81121 t jJ^ Cau ^ bt occurs during a non-atomic operation such 

device /sich r ^ d S t ’ wr,t *( S) ’ °P en ( s )> or ioctl(S) routine on a slow 
device (such as a terminal); or occurs during a sigpause(S) call- or 

°f cur . s danng a wai ‘(S) routine that does not return immediately,’the 
Slf!” 8 function will be executed and then the interrupted rou¬ 
tine may return a -1 to the calling process with errno set to EINTR. 

Seim^fthP !! 8Set S{ f CifleS * e $ y stem s ‘8 nal act ion to be taken upon 
receipt oi the argument sig. v 

If L!i nCt l 0n f,' gh0 [ d the function sigrelse establish critical regions 
c f a11 . t0 th e [unction sighold is analogous to raising the priority 
\ZiZ d £ T ng X holding a signal until the priority is lowered P by the 
1116 functlon sigrelse restores the system signal action 
to the action that was previously specified by the function sigset. 

The function sigignore sets the action for the argument sig to SIG_IGN. 

S« u SpendS th 5 ? alling process until it receives a signal, like 

f P w h ' H ,°r Ver> lf the Slgnal sig had been received and held, it is 
released and the appropriate action is taken. This system call is gen¬ 
erally used to test variables that changed when a signal is given The 

Sirs % £ us t si8h0,d “ a*-T»d£. fte 

signal CS ThCn ’ lf haVC not changed, use sigpause to wait for the 

Return Value 


If successful, the function sigset will return the previous value of the 
system signal action for the specified signal sig\ otherwise, it will 
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SIGSETV (S) 


return SIG_ERR and errno will indicate the error. 

For the functions sighold, sigpause, sigrelse, and sigignore a value of 
0 will be returned upon success. Otherwise, a value of -1 will be 
returned and errno will indicate the error. 

Errors 


Under the following conditions, the functions sigset, sighold, sig¬ 
pause, sigrelse, and sigignore will fail and will set errno to: 

EINTR A signal was caught during the execution of sig¬ 

pause. 

EINVAL if sig is an illegal signal number or SIGKILL or if 
the default handling of sig cannot be changed. 

Application Usage 

For portability, application-programs should use only the symbolic 
names of signals rather than their values and use only the set of sig¬ 
nals defined here. Specific implementations may have additional sig¬ 
nals. 

The other signal management routine, signal(S), should not be used in 
conjunction with these routines for a particular signal type. 

See Also 

kill(S), pause(S), signal(S), wait(S), setjump(S) 
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CATGETS (S) 


catgets 

read a program message 

Syntax 


#include <nl_types.h> 

SwaKlth <C “ ,d ' S ' 1 - n “ 1 "' "“S-"-"' s > 

int set_num, msg num; 
char *s; 

Description 


mSge a SSfogue idcmSTS-"^ “ se, - mm ■ fra " 

s^ssssassss 

Return Value 


fa u ^rK S£2sszas& “ ~szst. 

See Also 


catopen(S) 


Application Usage 


The message-text is contained 
copied by the application if it 
calls to catgets. 


in an internal buffer area and should be 
is to be saved or re-used after further 
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CATOPEN(S) 


catopen, catclose 

open/close a message catalogue 


Syntax 

include <nl_types.h> 


nl catd catopen (name, oflae) 
char *name; 
int oflag; 

int catclose (catd) 
nl_catd catd; 


Description 


ZT,sS S a STnZ C X ?“' “ d “ ca “°*" e ^riplcr. 

fu^ e d7<ri^S(U» i ^s»si s use ? wiui 

Archives: 

If the special syntax for name: 

<programname>@<archivename> 

IS Ca,0pen ' n,e environment 

tuted for %A (see envinWH/m ^ rcll,venar ^ e P^ of name substi- 
%A are recogSd men rh, 2$ P3rtS ° f ^ P ath containing a 

catclose closes the message catalogue identified by catd. 
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CATOPEN (S) 

Return Value 


CATOPEN (S) 


If s 
on 

ful, catopen returns {nl_cata>- 1 . 



catclose returns 0 if successful; otherwise it returns -1. 

See Also ------- 

catgets(S), environ(M) 

Standards Conformance ___ 

The capability to locate message catalogues in archives is specific to 


this implementation. 


Application Usage 


Using catopen may cause 
calling process, in additii 
should take care not to clc 


m aaaiuon iu ■>««»«, , 

not to close this file descriptor by mistake. 
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DUMPMSG (CP) 

dumpmsg 

generate a message source file" 

Syntax 


DUMPMSG (CP) 


dumpmsg f-XJ [- C ] catfile msgfile 

Description 


a me«af e r so£c?fil f e m £ SSag rf C f atalo S ue ca f‘le and generates 

standard output use instead of th^eSe^^ inpUt or write to 

The following options are recognized: 

J e fi su Pf 6X ^ ple ’ preload can 

-c noJ n ASr n rr the H X/0pen P°^bility guTdT P S abOUt “y fomat not 
„-ASC" » output us octul constants in a* fom w 


Exit Status 


dumpmsg returns 0 if successful n,« t >, • 

error: successful. The following values are returned on 

\ fatal error occurred. 

internal ’bug’ occurred. 

U encountered warnings 

encountered errors (and maybe warnings). 



gencat(CP), msginfo(F). 

Application Usage 

A text edttor may be used to make leading or trailing blanks visible. 

sage catalogue chmod.cal.addf tteSbl^ ** messa S es of mes- 
acterf"lmessages, surrounds all messageswkTthe ter ( " } t0 the 
«er ( ), and copies the processed data^o stcfou? doubIe ' c J uote char- 


17 July 1990 


DUMPMSG-1 




















DUMPMSG (CP) 


DUMPMSG (CP) 


to to, Le example, and represen. toe space character and toe 
tab character, respectively. 
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GENCAT (CP) 

gencat 

3 ,ormatteiJ '"essage catalogue" 

Syntax 


GENCAT (CP) 


gencat [ -X j catfile msgfile [ msg f ile ... j 

Description 


sssggessss^ 

^ f0U ° W "' 8 0p,i » s « recognized b, genca,: 

-X (resperaveTy) efn^Sfc*" 1 “ puI in lhe P 1 ®* of 

words. ana/or recognition of extra key 

Exit Status 

gencat returns 0 on success or 1 on failure. 

^?0^?!^i^onforman^ 

The -X option is specific to this i 

See Also 

msginfo(F). 

Application Usa ge 


implementation. 


«• ^ ° f maChlne ’ messa ^ cataC must E ^creaTeTv!^ 
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ICONV (CP) 

iconv 

international codeset conversion 

S yntax 

ico " v [ - hi mi -//««« 

Description 


ICONV (CP) 


iconv ~f I S8859 -t IS6937 datafile 
converts the file datafile from Kgsso 

reads the conversion tables fromS^A 6 " 00 ^ 1118 to IS693 7 encoding 
and writes the results on the SS t SSS^ / ^ /SSSS ^^ 

tory Swmder KTONVwhkh £ bvde^Tr'T deset “> subdirec- 
the conversion table specifies a mn^ de f aul ^ /usr ^ I ’b/nls. Each line in 

Sr S 4 ? on *"■ s «"6» 

tokens, the \ character is used iAI, tabs are used to delimit 
introduce (exactly) three digit octal rn^t * e °n Xt charact er and to 
stalling with a h«Sh m « L Blank Uks and linS 

f a sample conversion table 
fromcode tocod^ 


\# 

\040 

string 


The options are: 


tocode 

wasahash 
wasablank 
another\ 04 Ostring 


•i. pnnm. usage mcssage on ^ simdard ^ ou[put 

' d Kt sKSraa? sw “*• •—*. «* 

invahd characters. h ^ default 15 to pass through any 


Notes 


«* sienifKmt 
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conform to the maximal file name length (NAME_MAX). 

Files ____ 

$ICONV/conv/fromcoset_tocodest 
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mar _ 

message catalogue archive and library maintainer 

Syntax 


mar key [ option ] afile name ... 

Description 


files created by 

ate and update library files as used k C ' L Its main use 1S t0 cre- 
system. Any leading path will be stoW^T ** I" essa 8 e catalogue 
are already part of the archive, hencf PP d he " referencin 8 files that 

mar d msgarchive /usr/local/msgfilel 
is equivalent to 

mar d msgarchive msgfilel 

^JcL delete thC filC named ms ^ llel from the archive named 

v. afile is theTrchiv^file 116 Tbe i0n3lly Concatenated with 
archive file. The meaning?of fi,eS in the 

r fi,e ‘ ^ n ° HameS « 

archive fife? Xy ml™ fi A° r 3ppend them t0 the 

t S WU1 w Created if il does not aL P a?y exS ThC 

Um nmeS “ 

files named will be printed. P ’ If names 8 lven » only those 
P Print the named files to stdnm if « 

be printed. When piped to dumpmsgW) ?s “* glVCn ’ 311 fi,CS wiH 

mar p msgarchive msgfilel I dumpmsg - - 

StaS* ° f a11 meSSases “ "*= ^hive will be primed on 

archive will ^extracted ^ehher"^^ ^ 8 ! Vei1, 3,1 files in thc 
will alter the archive file * * ° ptlon nor 1116 P option 

' a fcccip- 

the constituent files. When used with f t ^ ° d archlve and 
information about the files includi™^ glVCS a l° ng llsting of a11 
update, its size and ShenLi“ £? Mnie of file - * last 

enced by catopen(S) cateets(S) and" 16 ? 386 Ca ™° 8ue as refer- 
P w> cat S^(S), and catgetmsgiS). The size of 
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the file is identical to the size as reported by ls(C). 


Files 


/tmp/msga msga temporaries 

Environment Variables 


. n mil atf affects the order in which the output is sorted for the 
, |p TIME affects the contents of date and time strings 

-t option; and LC_ I lMisanects uiec - d the neC essary 

date and time strings default to system specific formats. 


Standards Conformance 


This utility is specific to this implementation. 

See Also ___ 


gencat(CP), dumpmsg(CP), ar(CP), catopen(S) 

Application Usage _____ 

If the same file is mentioned twice in an argument list, it may be put in 
the archive twice. 

mar will be rather slow on big archives even when only deleting a sin¬ 
gle file. 


Note 


This version of mar uses a binary J^ive »hich is no,^ponal* 

ewe sssms 

archives have to be recreated by mar as well. 
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